home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / mui / mui-tools / multicx / multicx.doc < prev    next >
Text File  |  1995-03-09  |  9KB  |  262 lines
  1. ------------------------------------------------------------------------
  2.                         MultiCX 1.21 (28.11.94)
  3. ------------------------------------------------------------------------
  4.  
  5. MultiCX  is the smallest Multi-Function-Commodity for the Amiga, thought
  6. as  a replacement for many bigger and sometimes bad programmed programs.
  7. It  is  a  100%  clean  commodity,  which means that it does not use any
  8. patches  (SetFunction), no interrupts and no special input handlers.  So
  9. it could safely be disabled or removed at any time.
  10.  
  11. ------------------------------------------------------------------------
  12.                                 Features
  13. ------------------------------------------------------------------------
  14.  
  15. - Notification
  16.  
  17.   MultiCX  recognizes  any  changes  of  the ToolTypes while running, so
  18.   there's really no need for a GUI.
  19.  
  20. - Screen Blanker
  21.  
  22.   MultiCX  includes  a  simple but compatible screen blanker.  It always
  23.   uses  the display mode which fits best to the actual front screen, but
  24.   takes the lowest resolution with only one plane.
  25.  
  26.   ToolTypes:
  27.  
  28.   SCRBLANK=n            sets number of seconds until screen blanks,
  29.                         0 means OFF
  30.  
  31. - Mouse Accelerator
  32.  
  33.   MultiCX  lets  you  set Acceleration and Theshold (minimum movement to
  34.   activate Acceleration) for smooth mouse handling.
  35.  
  36.   ToolTypes:
  37.  
  38.   ACCELERATION=n        sets Acceleration factor, 0 means OFF
  39.   THRESHOLD=n           sets Threshold value, 0 means no Threshold
  40.  
  41. - Mouse Blanker
  42.  
  43.   MultiCX  blanks the mouse pointer on keypress and/or after approx.  30
  44.   seconds without having moved the mouse.
  45.  
  46.   ToolTypes:
  47.  
  48.   KEYBLANK              activates MouseBlanking on keypress
  49.   TIMEBLANK             activates MouseBlanking after timeout
  50.  
  51. - MMB Cycle
  52.  
  53.   MultiCX  allows  you to cycle screens using MiddleMouseButton, this is
  54.   eqivalent to LCOMMAND M.
  55.  
  56.   ToolTypes:
  57.  
  58.   MMBCYCLE              activates MMB Cycle
  59.  
  60. - Mouse Shift
  61.  
  62.   MultiCX  lets you use the RightMouseButton as a Shift-Key for extended
  63.   selection.  And this is how it works:
  64.  
  65.   1. Press the LeftButton anywhere and hold it.
  66.   2. Press RightButton and hold it.
  67.   3. Release LeftButton and keep RightButton pressed.
  68.   4. Now select some icons with extended selection.
  69.  
  70.   Sounds much more complicated than it is...
  71.  
  72.   ToolTypes:
  73.  
  74.   MOUSESHIFT            activates MouseShift
  75.  
  76. - Window Cycle
  77.  
  78.   MultiCX  lets  you put a window to front/back by a configurable number
  79.   of LeftButton clicks. Qualifiers can be defined for both functions.
  80.  
  81.   ToolTypes:
  82.  
  83.   WINCYCLE=n            sets number of clicks for WindowCycle,
  84.                         0 means OFF
  85.   WINFRONTQUAL=Qual     sets Qualifier for WindowToFront
  86.   WINBACKQUAL=Qual      sets Qualifier for WindowToBack
  87.  
  88. - SUN-alike Window Activation
  89.  
  90.   MultiCX has three different options to activate windows automatically.
  91.   All  of  them activate the window under the mouse pointer, SunKey does
  92.   it  on  every  keypress,  SunMouse  does  it after mouse movement, and
  93.   SunRMB  does  it after pressing the right mouse button.  So SunKey and
  94.   SunMouse together seem to be rather useless.
  95.   Windows  with  active Gadgets  (like FileRequesters etc) will never be
  96.   deactivated by one of these functions.
  97.  
  98.   ToolTypes:
  99.  
  100.   SUNKEY                activates SunKey
  101.   SUNMOUSE              activates SunMouse
  102.   SUNRMB                activates SunRMB
  103.  
  104. - HoldX and HoldY
  105.  
  106.   MiltiCX  allows you to lock a specific mouse dimension while holding a
  107.   defined Qualifier. If both Qualifiers are set to the same it locks all
  108.   mouse movements. So you are responsible for useful settings...
  109.  
  110.   ToolTypes:
  111.  
  112.   HOLDXQUAL=Qual        sets Qualifier for HoldX, none means OFF
  113.   HOLDYQUAL=Qual        sets Qualifier for HoldY, none means OFF
  114.  
  115. - Enter ASCII
  116.  
  117.   MultiCX  allows  you to enter ASCII codes directly using a pressed ALT
  118.   key  and  the  numbers in the numeric block, for example <ALT> 65 = A.
  119.   Maximum 3 digits, value must not be greater than 255.
  120.  
  121.   ToolTypes:
  122.  
  123.   ENTERASCII            activates EnterASCII
  124.  
  125. - CapShift
  126.  
  127.   This  option  changes  the  way  CapsLock  works.  Just try activating
  128.   CapsLock,  and  then  press some shifted letters to get an idea of it.
  129.   Hotkeys etc are no longer affected by CapsLock.
  130.  
  131.   ToolTypes:
  132.  
  133.   CAPSHIFT              activates CapShift
  134.  
  135. - Window Close/Zoom
  136.  
  137.   MultiCX  allows you to close/zoom windows using defined Qualifiers and
  138.   Keys.
  139.  
  140.   ToolTypes:
  141.  
  142.   WINCLOSE=Qual&Key     sets Qualifier and Key for CloseWindow,
  143.                         none means OFF
  144.   WINZOOM=Qual&Key      sets Qualifier and Key for ZoomWindow,
  145.                         none means OFF
  146.  
  147. - Window Remember
  148.  
  149.   MultiCX  remembers  the  last  active window on every screen, and next
  150.   time  you  go  to  that  screen,  this  window  will  be  re-activated
  151.   automatically.
  152.  
  153.   ToolTypes:
  154.  
  155.   WINREMEMBER           activates WindowRemember
  156.  
  157. - PopCLI
  158.  
  159.   MultiCX  spawns  a  UserShell  using  the  given  command  string when
  160.   pressing  the  PopCLI  key.  Optionally the Workbench may be popped to
  161.   front first.
  162.  
  163.   ToolTypes:
  164.  
  165.   POPCLI=Qual&Key       sets Qualifier & Key for PopCLI, none means OFF
  166.   POPCLICMD=Command     sets command string for PopCLI, none means OFF
  167.   WBTOFRONT             activates WBToFront for PopCLI
  168.  
  169. - System Flags
  170.  
  171.   MultiCX lets you set/change some of the internal AmigaOS flags.  These
  172.   may  be  set,  unset  or  left unchanged, where a parameter of 0 means
  173.   deactivate, 1 or any value >0 means activate, and putting the ToolType
  174.   in brackets (the same as removing it) means no change.  Old values are
  175.   NOT  restored when quitting/disabling MultiCX, but Notofication may be
  176.   used at any time.
  177.  
  178.   ToolTypes:
  179.  
  180.   BLACKBORDER=n         changes BlackBorder flag, ECS Denise needed
  181.   NOCLICK=n             changes NoClick flag for all drives,
  182.                         may not work with very old drives
  183.   WILDSTAR=n            changes flag for extended WildCarding,
  184.                         if ON "*" may be used instead of "#?"
  185.  
  186. ------------------------------------------------------------------------
  187.                             Notes and Hints
  188. ------------------------------------------------------------------------
  189.  
  190. - MultiCX must be started from WB, CLI/Shell is not supported.
  191.  
  192. - MultiCX  is  100%  compatible to Commodore's  specifications, so don't
  193.   complain if some bad-behaving software does not work with it.
  194.  
  195. - MultiCX's  Screen  Blanker  uses  BestModeID to find  the best display
  196.   mode.   Because  this is not possible under AmigaOS 2.x MultiCX uses a
  197.   special masking algorythm to find the display mode. But this relies on
  198.   the fact, that a DisplayID with all ModeKeys set to 0 exists.
  199.   Anyway you should use AmigaOS 3.x for best results.
  200.  
  201. - BlackBorder is not fully supported by AmigaOS 2.x, but should work.
  202.  
  203. - Some very old drives do not like NoClick,  so switch it off at once if
  204.   your drive makes funny noises...
  205.  
  206. - If  you  like to toggle some of MultiCX's features using  hotkeys, you
  207.   should try ToolManager 2.1 (by Stefan Becker) together with DoIcon (by
  208.   Lars Eilebrecht).
  209.  
  210. - MultiCX  may be enabled/disabled/removed  from within scripts by using
  211.   HandleCX (included in this archive).
  212.  
  213. ------------------------------------------------------------------------
  214.                                 History
  215. ------------------------------------------------------------------------
  216.  
  217. 1.00 - 1.20     internal Beta releases
  218.  
  219.        1.21     first public release
  220.  
  221. ------------------------------------------------------------------------
  222.                                  Author
  223. ------------------------------------------------------------------------
  224.  
  225.  
  226.                              Martin Berndt
  227.  
  228.                           Fr.-Alfred-Str. 115
  229.                              47226 Duisburg
  230.  
  231.                                 Germany
  232.  
  233.                     E-Mail: m_berndt@wanderer.gun.de
  234.  
  235.  
  236. ------------------------------------------------------------------------
  237.                               Legal Stuff
  238. ------------------------------------------------------------------------
  239.  
  240. MultiCX  is  GIFTWARE,  so simply send be anything you like.  Gold bars,
  241. Ferraris and jobs in the US are prefered...  ;-)
  242.  
  243.  
  244. Copyright
  245. ---------
  246. MultiCX  is  written and copyright © 1994 by Martin Berndt.  No parts of
  247. this  program  may  be  altered  by  any  means  (this includes editing,
  248. reprogramming, crunching, resourceing etc.), except archiving.
  249.  
  250. Disclaimer
  251. ----------
  252. The  author  is in no way liable for any changes made to any part of the
  253. program,  or  consequences thereof as he is in no way liable for damages
  254. or loss of data directly or indirectly caused by this software.
  255.  
  256. Distribution
  257. ------------
  258. Neither fees may be charged nor profits may be made by distributing this
  259. piece  of  software.  Only a nominal fee for costs of magnetic media may
  260. be  accepted,  the  amount  of  US  $5  shouldn't be exceeded for a disk
  261. containing MultiCX.
  262.